home *** CD-ROM | disk | FTP | other *** search
/ Aminet 24 / Aminet 24 (1998)(GTI - Schatztruhe)[!][Apr 1998].iso / Aminet / biz / dopus / Cuido.lha / Cuido / Cuido.readme next >
Text File  |  1998-02-22  |  6KB  |  164 lines
  1. Short: Open Opus 5 listers from shell easily.
  2. Author: Matthew Gregan (kinetik@caverock.net.nz)
  3. Uploader: Matthew Gregan (kinetik@caverock.net.nz)
  4. Type: biz/dopus
  5. Requires: Directory Opus 5.5+, ARexx
  6. Version: 1.1
  7. Replaces: biz/dopus/Cuido.lha
  8.  
  9. Cuido v1.1, Copyright ©1998 Matthew Gregan.
  10. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  11.  
  12. Introduction:
  13. ~~~~~~~~~~~~~
  14.  After using Opus for a while, I found that I needed a way to open listers
  15. from the shell. I originally wrote this program sometime in 1997, and it
  16. served it's purpose. But then I noticed some problems with it, namely it
  17. didn't handle spaces in pathnames, and some of the other pathing functions.
  18. I sat down and spent a while tidying up the code and speeding it up where
  19. it could be (the original version was written in less than five minutes,
  20. and it showed) and I ended up with Cuido.
  21.  
  22.  
  23. Usage:
  24. ~~~~~~
  25.  You can use Cuido in the shell, by setting up an alias somewhere in your
  26. S:Shell-Startup, and copying Cuido to the correct place as follows:
  27.  
  28.  
  29.     Copy Cuido.rexx DOpus5:Arexx/
  30.     Alias Cuido RX DOpus5:Arexx/Cuido.rexx
  31.  
  32.  
  33.  Now, you can use Cuido in your shell. Here are some examples:
  34.  
  35.  
  36.     Kinematics:> Cuido RAM:
  37.         This will open a new lister in with it's path set to RAM:
  38.  
  39.     Kinematics:> Cuido
  40.         This will open the current directory (in this case, Kinematics:)
  41.         into a new lister.
  42.  
  43.     Kinematics:Devs/DOSDrivers> Cuido /Printers
  44.         This will open Kinematics:Devs/Printers into a new lister.
  45.  
  46.  
  47.  Cuido also supports opening multiple listers by simply typing a path for
  48. each lister you wish to open, for example:
  49.  
  50.  
  51.     Kinematics:> Cuido DH1: Temp2: RAM:
  52.         This will open three new listers, with their respective paths.
  53.  
  54.  
  55.  If you are using multiple paths, and one of them needs to be the current
  56. directory, use double quotes, or a '.' if you're using the UnixDirs patch.
  57.  
  58.  
  59.     Kinematics:> Cuido DH1: "" Temp2:
  60.         This is the 'standard' Amiga way to refer to the current directory.
  61.  
  62.  
  63.  Alternatively, you can put in somewhere in your command path, and set the
  64. script bit on the file, like this:
  65.  
  66.  
  67.     Copy Cuido.rexx C:Cuido
  68.     Protect C:Cuido +S
  69.  
  70.  
  71.  Now you can use Cuido from the shell without an alias, and without having
  72. to call RX. There is no real advantage with this way, or the alias way.
  73. It's just a matter of taste.
  74.  
  75.  As you can see, using Cuido is very straight-forward, and easy. You shouldn't
  76. have any problems, but if you do, feel free to contact me and ask for help.
  77.  
  78.  Another use for Cuido is to create a hotkey in Opus, and set it to call
  79. Cuido and open a requester to ask the path... This is a fast alternative to
  80. opening a lister and clicking your way there. And I'm sure there are other
  81. uses too...
  82.  
  83.  
  84. Legal:
  85. ~~~~~~
  86.  This program is freeware. This means you are able to freely distribute it
  87. and use it, without having to pay the author. If you wish to include it
  88. with another program, please email me first for permission. Also, I am not
  89. liable for any damages or problems arising from the use of the program,
  90. directly or indirectly.
  91.  
  92.  Directory Opus is Copyright ©1997 Jonathan Potter & GPSoftware
  93.  
  94.  Cuido is Copyright ©1998 Matthew Gregan
  95.  
  96.  All other Copyrights are © their respective owners.
  97.  
  98.  
  99. History:
  100. ~~~~~~~~
  101. Version        Date                Notes
  102.  
  103.  1.1        1998-02-22            No changes to the actual script, but I've
  104.                                 bumped the version number in it. The only
  105.                                 changes I've made are to this readme. I
  106.                                 actually proof-read this one, and realised
  107.                                 I'd messed it up a bit. Sorry about that,
  108.                                 but I *did* write the original at 4am. :)
  109.  
  110.  1.0        1998-02-17            First public/Aminet release. No major
  111.                                 changes from 0.9, but I just wrote some
  112.                                 documentation and tidied up the Arexx code
  113.                                 a little (ie: removed the debug code).
  114.  
  115.  0.9        1998-02-16            This is the pre-Aminet version. I realised
  116.                                 my path parsing didn't support some of the
  117.                                 other Amiga path quirks, like multiple
  118.                                 slashes to traverse dirs. After
  119.                                 implementing a quick and easy fix, I found
  120.                                 a much better way to handle all of the
  121.                                 paths, which involved rewriting almost the
  122.                                 entire program. Damn.
  123.  
  124.  0.5        1998-02-11            Path parsing improved dramatically in 0.5.
  125.                                 Now it supports paths with spaces, using
  126.                                 quotes.
  127.  
  128. <0.5        1997                First versions of Cuido, called CDO at this
  129.                                 stage. These versions had some very lame
  130.                                 routines in them.
  131.  
  132.  
  133. Bugs:
  134. ~~~~~
  135.  The only bug in Cuido, is very slight and should cause no problems.
  136. Basically, if you give Cuido a directory or device which it can't access,
  137. it will open the current directory in it's place. I think this is better
  138. than returning an error, since it's likely that the dir is inaccessible
  139. because you misspelled it, or something. So opening a lister in the current
  140. dir will mean you have a lister free for the correct path. If this
  141. bug/feature causes any problems, let me know and I'll change it.
  142.  
  143.  
  144. Author:
  145. ~~~~~~~
  146. Matthew Gregan
  147. EMail: kinetik@caverock.net.nz
  148. IRC: Kinetik on A-Net #Amiga
  149.  
  150.  Drop me an email saying you're using Cuido, if you like. Let me know if you
  151. like it, hate it, or whatever. If you have problems using it, or would like
  152. to report a bug, email me at the above address.
  153.  
  154.  
  155. Thanks:
  156. ~~~~~~~
  157.  Thanks to Marcel 'Xar' Weber (MW@netaccess.co.nz) for beta testing, and
  158. for writing the quote parsing code on his machine, and reading it to me
  159. over the phone. This was much easier than actually having to think for
  160. myself.
  161.  
  162.  Also thanks to Wayne 'TB' Martin (tb@amiga.org) for being the champion of
  163. Daytona, one time running.
  164.